home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / csa.z / csa
Encoding:
Text File  |  2001-04-17  |  11.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ccccssssaaaa((((1111MMMM))))                                                                ccccssssaaaa((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      csa - overview of Comprehensive System Accounting (CSA)
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The IRIX operating system supports three accounting packages: standard
  13.      UNIX System V accounting, IRIX extended accounting, and IRIX
  14.      Comprehensive System Accounting (CSA).  CSA is a set of C programs and
  15.      shell scripts that, like the other accounting packages, provide methods
  16.      for collecting per-process resource usage data, monitoring disk usage,
  17.      and charging fees to specific login accounts.
  18.  
  19.      CSA provides the following features which are not available with the
  20.      other accounting packages:
  21.  
  22.      +o   Per-job accounting
  23.  
  24.      +o   Daemon accounting (tape, NQS, and workload management systems)
  25.  
  26.      +o   Flexible accounting periods (daily and periodic accounting reports
  27.          can be generated as often as desired and not restricted to once per
  28.          day or once per month)
  29.  
  30.      +o   Flexible system billing units (SBUs)
  31.  
  32.      +o   Offline archiving of accounting data
  33.  
  34.      +o   User exits for site specific customization of daily and periodic
  35.          accounting
  36.  
  37.      +o   Configurable parameters within the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file
  38.  
  39.      +o   User job accounting (_jjjj_aaaa(1) command)
  40.  
  41.      CSA takes this per-process accounting information and combines it by job
  42.      identifier (_jjjj_iiii_dddd) within system boot uptime periods.  CSA accounting for
  43.      an interactive job consists of all accounting data for a given job
  44.      identifier during a single system boot period.  CSA accounting for a
  45.      batch job includes the accounting data associated with the batch system
  46.      identifier, which may consist of one or more job identifiers and may span
  47.      multiple reboots.
  48.  
  49.      Daemon accounting records are written at the completion of daemon
  50.      specific events.  These records are combined with per-process accounting
  51.      records associated with the same interactive or batch job.
  52.  
  53.      By default, CSA only reports accounting data for terminated jobs.
  54.      Interactive jobs, _cccc_rrrr_oooo_nnnn jobs and _aaaa_tttt jobs terminate when the last process
  55.      in the job exits, which is normally the login shell.  An NQS or workload
  56.      management job is recognized as terminated by CSA based upon daemon
  57.      accounting records and an end-of-job record for that job.  Jobs which are
  58.      still active are recycled into the next accounting period.  This behavior
  59.      can be changed through use of the _cccc_ssss_aaaa_rrrr_uuuu_nnnn _----_AAAA option.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccssssaaaa((((1111MMMM))))                                                                ccccssssaaaa((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      A system billing unit (SBU) is a unit of measure that reflects use of
  75.      machine resources.  SBUs are defined in the CSA configuration file
  76.      _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff and are set to _0000_...._0000 by default.  The weighting factor
  77.      associated with each field in the CSA accounting records can be altered
  78.      to obtain an SBU value suitable for your site.  See the _I_R_I_X _A_d_m_i_n:
  79.      _R_e_s_o_u_r_c_e _A_d_m_i_n_i_s_t_r_a_t_i_o_n manual for further information.
  80.  
  81.      The CSA accounting records are not written into the System V pacct file
  82.      but are written into a separate CSA _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt file.  The
  83.      CSA commands can only be used with CSA generated accounting records.
  84.      Similarly, the System V accounting commands can only be used with System
  85.      V generated accounting records.
  86.  
  87.      There are four user exits available with the _cccc_ssss_aaaa_rrrr_uuuu_nnnn(1M) daily accounting
  88.      script.  There is one user exit available with the _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd(1M) periodic
  89.      accounting script.  These user exits allow sites to tailor the daily and
  90.      periodic run of accounting to their specific needs by creating user exit
  91.      scripts to perform any additional processing and to allow for archiving
  92.      of accounting data.  See the _cccc_ssss_aaaa_rrrr_uuuu_nnnn(1M) and _cccc_ssss_aaaa_pppp_eeee_rrrr_iiii_oooo_dddd(1M) man pages for
  93.      further information.
  94.  
  95.      CSA provides two user accounting commands, _cccc_ssss_aaaa_cccc_oooo_mmmm(1) and _jjjj_aaaa(1).  The
  96.      _cccc_ssss_aaaa_cccc_oooo_mmmm command reads the CSA pacct file and writes selected accounting
  97.      records to standard output.  The _cccc_ssss_aaaa_cccc_oooo_mmmm command is very similar to the
  98.      System V _aaaa_cccc_cccc_tttt_cccc_oooo_mmmm(1) command.  The _jjjj_aaaa command provides job accounting
  99.      information for the current job of the caller.  This information is
  100.      obtained from a separate user job accounting file to which the kernel
  101.      writes.  See the _cccc_ssss_aaaa_cccc_oooo_mmmm(1) and _jjjj_aaaa(1) man pages for further information.
  102.  
  103.      The _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file contains CSA configuration variables.  These
  104.      variables are used by the CSA commands.
  105.  
  106.      Like any accounting or monitoring package, the CSA features do contribute
  107.      to overall system overhead.  For this reason, CSA is disabled in the
  108.      kernel by default.  To enable CSA, use the _ssss_yyyy_ssss_tttt_uuuu_nnnn_eeee(1M) program to modify
  109.      the following variable:
  110.  
  111.      _dddd_oooo______cccc_ssss_aaaa_aaaa_cccc_cccc_tttt     Enables CSA job accounting if non-zero
  112.  
  113.      The _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command is used to dynamically configure on or off CSA
  114.      record types, set memory and I/O threshold values, switch the CSA pacct
  115.      file, and provide status information.  See the _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh(1M) man page for
  116.      further information.
  117.  
  118.      CSA can be automatically configured _oooo_nnnn across system reboots using the
  119.      _cccc_hhhh_kkkk_cccc_oooo_nnnn_ffff_iiii_gggg _cccc_ssss_aaaa_aaaa_cccc_cccc_tttt _oooo_nnnn command.
  120.  
  121. IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN////SSSSTTTTAAAARRRRTTTTUUUUPPPP SSSSUUUUMMMMMMMMAAAARRRRYYYY
  122.      The following steps are required to set up CSA job accounting:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccssssaaaa((((1111MMMM))))                                                                ccccssssaaaa((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      +o   Enable CSA within the kernel by using the _ssss_yyyy_ssss_tttt_uuuu_nnnn_eeee utility to set
  141.          _dddd_oooo______cccc_ssss_aaaa_aaaa_cccc_cccc_tttt to a non-zero value
  142.  
  143.      +o   Use the _iiii_nnnn_ssss_tttt(1M) utility to install the _eeee_oooo_eeee_...._ssss_wwww_...._cccc_ssss_aaaa_aaaa_cccc_cccc_tttt subsystem from
  144.          your IRIX distribution media.  Installing CSA also requires the
  145.          _eeee_oooo_eeee_...._ssss_wwww_...._aaaa_cccc_cccc_tttt and _eeee_oooo_eeee_...._ssss_wwww_...._jjjj_llll_iiii_mmmm_iiii_tttt_ssss subsystems to be installed.  It will
  146.          be necessary to reboot the system after completing this step.
  147.  
  148.      +o   Configure CSA _oooo_nnnn across system reboots by using the _cccc_hhhh_kkkk_cccc_oooo_nnnn_ffff_iiii_gggg utility
  149.          as follows:
  150.  
  151.           _cccc_hhhh_kkkk_cccc_oooo_nnnn_ffff_iiii_gggg _cccc_ssss_aaaa_aaaa_cccc_cccc_tttt _oooo_nnnn
  152.  
  153.  
  154.      +o   Modify the CSA configuration variables in _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff as desired
  155.  
  156.      +o   Use _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh to configure on the accounting record types and
  157.          thresholds defined in _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff as follows:
  158.  
  159.           _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh _----_cccc _oooo_nnnn
  160.  
  161.  
  162.      This step will be done automatically for subsequent system reboots when
  163.      CSA is configured on via the _cccc_hhhh_kkkk_cccc_oooo_nnnn_ffff_iiii_gggg(1M) utility.
  164.  
  165. FFFFIIIILLLLEEEESSSS
  166.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt                   Contains the CSA administrator commands
  167.  
  168.      _////_uuuu_ssss_rrrr_////_bbbb_iiii_nnnn                        Contains the CSA user commands, _cccc_ssss_aaaa_cccc_oooo_mmmm
  169.                                      and _jjjj_aaaa
  170.  
  171.      _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff                   CSA configuration file
  172.  
  173.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt         Current process accounting file
  174.  
  175.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ssss_uuuu_mmmm_////_cccc_ssss_aaaa           CSA daily reports and data files
  176.  
  177.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_ffff_iiii_ssss_cccc_aaaa_llll_////_cccc_ssss_aaaa        CSA periodic reports and data files
  178.  
  179. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  180.      acctdisk(1M), chargefee(1M), csaaddc(1M), csabuild(1M), csachargefee(1M),
  181.      csackpacct(1M), csacms(1M), csacom(1), csacon(1M), csacrep(1M),
  182.      csadrep(1M), csaedit(1M), csagetconfig(1M), csajrep(1M), csaperiod(1M),
  183.      csarecy(1M), csarun(1M), csaswitch(1M), csaverify(1M), dodisk(1M), ja(1),
  184.      lastlogin(1M).
  185.  
  186.      _IIII_RRRR_IIII_XXXX _AAAA_dddd_mmmm_iiii_nnnn_:::: _RRRR_eeee_ssss_oooo_uuuu_rrrr_cccc_eeee _AAAA_dddd_mmmm_iiii_nnnn_iiii_ssss_tttt_rrrr_aaaa_tttt_iiii_oooo_nnnn
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.